2天狂揽3w stars，火爆全网的私人 AI 工作空间
2天狂揽3w stars，火爆全网的私人 AI 工作空间
来源：htmlDecode("GitHubStore")
原文链接：https://mp.weixin.qq.com/s/-1Cs7xODfjQdBzP4K7GRbg
**
**
项目简介
** Odysseus ** 是一个 ** 自托管的 AI 工作空间 ** —— 旨在提供类似 ChatGPT 和 Claude 的界面体验，但更具个性、更多趣味。在你自己的硬件上运行，使用你自己的数据 —— ** 本地优先、隐私优先、无后门 ** 。简单理解，就是想在自己电脑或服务器上，跑一个类似 ChatGPT/Claude 的工具，但数据全在本地，不依赖云端，也不把隐私交给大公司。
特性
** 聊天 ** —— 与任意本地模型或 API 对话，添加模型非常简单。
vLLM · llama.cpp · Ollama · OpenRouter · OpenAI
** Agent（智能体） ** —— 赋予工具，让它自主完成整个任务。
基于 opencode · MCP · 网页 · 文件 · Shell · 技能 · 记忆
** Cookbook（食谱） ** —— 扫描你的硬件，推荐模型，一键下载并启动服务。
基于 llmfit · VRAM 感知 · GGUF / FP8 / AWQ · 适配度评分 · vLLM / llama.cpp 服务
** 深度研究 ** —— 多步执行，收集、阅读并综合来源，生成精美的可视化报告。
改编自 Tongyi DeepResearch
** 模型对比 ** —— 有趣的并排对比工具，支持完全盲测，无偏见！
多模型 · 盲测 · 综合分析
** 文档编辑 ** —— ** 你 ** 来写作，AI 辅助而非主导。
多标签编辑器 · Markdown · HTML · CSV · 语法高亮 · AI 编辑 · 建议
** 记忆 / 技能 ** —— 持久化记忆和技能，你的智能体会随着时间更好地理解你和你的任务而不断进化！
ChromaDB · fastembed (ONNX) · 向量 + 关键词检索 · 导入/导出
** 邮件 ** —— 内置 IMAP/SMTP 收件箱 + AI 智能分类：紧急提醒、自动标签、自动摘要、自动回复草稿、自动垃圾邮件过滤。
IMAP · SMTP · 按账号路由 · CalDAV 感知
** 笔记 & 任务 ** —— 带提醒的快速笔记、待办清单，以及智能体可以执行的定时任务。
笔记推送 · 检查清单 · cron 风格任务 · ntfy / 浏览器 / 邮件通知
** 日历 ** —— 本地优先的日历，支持 CalDAV 同步至 Radicale / Nextcloud / Apple / Fastmail。
CalDAV 拉取 · .ics 导入/导出 · 按日历颜色 · 智能体感知
** 移动端支持 ** —— 在手机上也能良好显示和运行。
响应式 · 可安装 (PWA) · 触屏手势
** 更多功能 ** —— 值得探索！
图片编辑器 · 主题编辑器 · 文件上传（视觉 + PDF） · 网页搜索 · 预设 · 会话 · 2FA
演示
快速开始
默认配置开箱即用：克隆仓库 → 运行 → 在 ** 设置 ** 中配置模型、搜索、邮件等。
仅在需要部署级覆盖（如 APP_BIND 、 APP_PORT 、 AUTH_ENABLED 等）时才修改 .env 文件。
首次启动时，Odysseus 会创建一个管理员账号（默认为 admin ，可通过 ODYSSEUS_ADMIN_USER 修改），并在终端打印临时密码。
Docker 安装时可在 docker compose logs odysseus 中查看该密码。首次登录后请立即在 ** 设置 ** 中修改密码。
想贡献代码？请参考 CONTRIBUTING.md。
Docker（推荐）
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env # 推荐，明确默认配置
docker compose up -d --build
容器健康后访问 http://localhost:7000 。
Docker Compose 默认绑定 127.0.0.1 ，如端口被占用，可在 .env 中设置 APP_PORT=7001 后重建容器。仅在需要 LAN 或反向代理访问时才将 APP_BIND=0.0.0.0 。
原生 Linux / macOS
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000
要求：Python 3.11+。Cookbook 需要 tmux 来后台下载和运行模型。仅在需要 LAN/反向代理时使用 --host 0.0.0.0 。
Apple Silicon（M 系列）
Docker 在 macOS 上无法使用 Metal GPU。若需在 M 系列 Mac 上使用 GPU 加速的 Cookbook，请原生运行：
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
./start-macos.sh
默认运行在 http://127.0.0.1:7860 。
想通过 Tailscale 等可信 LAN 访问手机，可使用：
ODYSSEUS_HOST=0.0.0.0 ./start-macos.sh
构建可点击的 macOS App：
./build-macos-app.sh
原生 Windows
** 一键启动器 ** （推荐，安全可重复运行）：
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1
或手动安装：
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
py -3.11 -m venv venv
venv\Scripts\Activate.ps1
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000
项目地址
https://github.com/pewdiepie-archdaemon/odysseus
**
**
如果你觉得这篇文章不错，别忘了 ** 点赞、在 ** ** 看、转发 ** 给更多需要的小伙伴哦！
** 技术 / 产品交流 ** 扫码加入交流群，备注格式： ** 「开发语言-城市-昵称」 **
其他合作 请注明来意